home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 4 / Meeting Pearls Vol. IV (1996)(GTI - Schatztruhe)[!].iso / Pearls / mus / DiskChanger / DiskChanger.Doc next >
Text File  |  1996-06-21  |  7KB  |  191 lines
  1. DiskChanger
  2.  
  3.     Documentation of the Diskchanger-Genie
  4.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  5.     Copyright © 1995 by Daniel Balster,
  6.     All Rights Reserved.
  7.     READY.
  8.  
  9.  
  10.     What is Diskchanger ?
  11.     ---------------------
  12.     
  13.     Delitracker can create and use program lists. This lists are useful
  14.     if you have many modules on CDROM or other type of media.
  15.     
  16.     "DiskChanger" observes now a given device and if a medium has changed
  17.     it loads its program list. favorites for this job are CDROMs, like
  18.     CD0: is.
  19.  
  20.     If you change now a CD DeliTracker will load its list; music is
  21.     playing now continously, no matter if you change a CD during your work.
  22.     
  23.  
  24.     Usage of the Diskchanger Genie
  25.     ------------------------------
  26.     
  27.     (a) Create a database
  28.     
  29.     First you have to create program lists for each medium that you want to be
  30.     recognized during a mediachange; this could be whole index of the medium
  31.     or just a selection. Use DeliTracker to create this lists.
  32.  
  33.     Since you have created all this lists you must enter them in a kind of
  34.     database, and that looks like this: (for some well known CDs)
  35.  
  36. -8<-cut-here----------------------------------------------------------------------
  37. ; media database for delitracker
  38.  
  39. AMINET_0794:       AUDIO:DeliTracker/DeliConfig/aminet3.program
  40. AMINET4:           AUDIO:DeliTracker/DeliConfig/aminet4.program
  41. AMINET5:           AUDIO:DeliTracker/DeliConfig/aminet5.program
  42. AMINET6:           AUDIO:DeliTracker/DeliConfig/aminet6.program
  43. AMINET7:           AUDIO:DeliTracker/DeliConfig/aminet7.program
  44. SET1D:             AUDIO:DeliTracker/DeliConfig/aminetset1.program
  45. Asmrom94:          AUDIO:DeliTracker/DeliConfig/assembly94.program
  46. Meeting_Pearls_I:  AUDIO:DeliTracker/DeliConfig/meetingpearls1.program
  47. Meeting_Pearls_II: AUDIO:DeliTracker/DeliConfig/meetingpearls2.program
  48. ModulesMagic:      AUDIO:DeliTracker/DeliConfig/modulesmagic.program
  49.  
  50. ; this is the default fallback, if no CD is inserted
  51.  
  52. default:           AUDIO:DeliTracker/DeliConfig/actual.program
  53. ----------------------------------------------------------------------------------
  54.  
  55.     On the left you can see the exact volume name and on the right you
  56.     can find the name and path of the volumes' program list. lines that
  57.     begin with the colon (;) can be used as comments.
  58.  
  59.     The "default:" entry has a special function: this program will always
  60.     be loaded, if the volume can't be found in the database or the drive
  61.     is just empty. Make sure that the "default:" program contains only of
  62.     always available modules, this are modules on your internal harddrive,
  63.     you can keep your favorites there!
  64.  
  65.     You can find two shell scripts in the "DiskChanger" distribution,
  66.     they're needed to parse the database; DeliInsertDisk and DeliRemoveDisk.
  67.     entsprechenden Aktionen aufgerufen.
  68.  
  69.     (b) activating and configuring the genie
  70.  
  71.     Choose "ADD" in the "Genies" Dialog of Delitracker and add the "DiskChanger"
  72.     Genie (for a permanent usage just copy it into the DeliGenies/ drawer).
  73.     Select now "DiskChanger" and click on "SHOW". Here comes an explanation
  74.     of the gadgets
  75.     
  76.     ------------------------------------------------------------
  77.                   ______________________________________________
  78.     Insert Delay |______________#_______________________________|
  79.                   ______________________________________________
  80.     Remove Delay |______________#_______________________________|
  81.                   ______________________________________________
  82.      New Program |@|__________Load and play immediately_________|
  83.                   ______________________________________________
  84.         Database |______________________________________________|
  85.                   ______________________________________________
  86.       Devicename |______________________________________________|
  87.                   ______________________________________________
  88.     Insertscript |______________________________________________|
  89.                   ______________________________________________
  90.     Removescript |______________________________________________|
  91.  
  92.      _____________          _____________          _____________
  93.     |____About____|        |_____Save____|        |_____Hide____|
  94.     
  95.     ------------------------------------------------------------
  96.     
  97.     Database        Enter the name and path of your database here.
  98.                 Example: "S:media.database"
  99.     
  100.     Devicename    Enter the device to notify here. Only a device
  101.                 name is allowed that is also listed in the out-
  102.                 put of the command "ASSIGN DEVICES"
  103.                 Example: "CD0:"
  104.     
  105.     Insertscript    Enter here, where you have copied the delivered
  106.                 script "DeliInsertDisk". In this gadget the call
  107.                 parameters are defined. No long words, enter
  108.                 "EXECUTE S:DELIINSERTSCRIPT %s %s"
  109.                 here.
  110.     
  111.     Removescript    The same as for "Insertscript", but enter 
  112.                 "EXECUTE S:DELIREMOVESCRIPT %s"
  113.                 here.
  114.     
  115.     Save            saves the configuration
  116.  
  117.     About        shows some information about the author
  118.     
  119.     Hide            hides the window.
  120.     
  121.     New_Programm    There are three ways how to handle new programs:
  122.             
  123.     
  124.                 "Load and play immediatly"
  125.                 - loads the program and plays it immediatly
  126.     
  127.                 "Load, but do not play"
  128.                 - loads the program, but does not start it
  129.     
  130.                 "Load and wait for SongEnd"
  131.                 - this should wait for the current module to finish,
  132.                 but this DOES NOT WORK yet. do not use.
  133.  
  134.     Insert Delay
  135.     Remove Delay    Some drive types (like CD, TAPE and MO drives) need
  136.                 some spindle and access time. normally, if you have
  137.                 inserted a new CD, the genie will try IMMEDIATELY to
  138.                 access the new modules on there. this would cause a
  139.                 "Please insert disk xyz" request. with this two delays
  140.                 you can specify the delays before it should access
  141.                 the new lists.
  142.                 
  143.                 With "InsertDelay" you specify the delay before a new
  144.                 medium is accessed.
  145.                 
  146.                 With "RemoveDelay" you specify the (longer) delay before
  147.                 the "default:" program is to be loaded. this is needed,
  148.                 because changing a CD manually takes time; and even
  149.                 if it took a second the genie would load the default program.
  150.                 with this slider you can prevent this behaviour.
  151.                 
  152.                 both values are custom and depend on your configuration!
  153.                 just try!
  154.  
  155.  
  156.     (c) misc
  157.  
  158.     Look into the menubar of the genies' window, read the delitracker docs how
  159.     to use them.
  160.  
  161.     This Genie is a hybrid-program. it makes use of external software.
  162.     
  163.     Software            Comment
  164.     ------------------------------------------------------------------------
  165.     
  166.     Execute            standard (should be resident)
  167.     C:RequestChoice    standard since OS 3.0
  168.     sys:rexxc/rx        standard (AREXX)
  169.     C:Type            standard (shell)
  170.     C:Search            standard (shell)
  171.  
  172.     PIPE:            Pipe-Handler (DEVS:DOSDRIVERS/PIPE or Mount PIPE:)
  173.  
  174.     If your amiga system is configured well this all should be no problem.
  175.  
  176.     ------------------------------------------------------------------------
  177.  
  178.     Refer to the DeliTracker documentation for further details.
  179.     
  180.     ------------------------------------------------------------------------
  181.     
  182.     Questions ? Comments ? Bugs ?
  183.     
  184.     Daniel Balster,    dbalster@uni-paderborn.de oder dbalster#amigager (irc)
  185.     Max-Reger Weg 48
  186.     33100 Paderborn
  187.  
  188.     ------------------------------------------------------------------------
  189.     (note: I have problems in writing and thinking english, I hope you
  190.     have understood all this - if not drop me an email or smail)
  191.